From 747c834f27d2c166ffa2c0b3b9dc0e467aff3578 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 21 May 2010 22:07:46 -0400
Subject: [PATCH] Document GSEAL_ENABLE with other preprocessor symbols.

---
 docs/reference/gtk/compiling.sgml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/reference/gtk/compiling.sgml b/docs/reference/gtk/compiling.sgml
index a9a3632a91..c5e58b79c5 100644
--- a/docs/reference/gtk/compiling.sgml
+++ b/docs/reference/gtk/compiling.sgml
@@ -81,5 +81,14 @@ The same for <filename>gtkunixprint.h</filename> if you use the non-portable
 <link linkend="GtkPrintUnixDialog">GtkPrintUnixDialog</link> API.
 </para>
 
+<para>
+The next major version, GTK+ 3,  will remove many implementation details and
+struct members from its public headers. To ensure that your application will
+not have problems with this, you can define the preprocessor symbol
+GSEAL_ENABLE. This will make the compiler catch all uses of direct access to
+struct fields so that you can go through them one by one and replace them with
+a call to an accessor function instead.
+</para>
+
 </refsect1>
 </refentry>
-- 
2.30.2